home *** CD-ROM | disk | FTP | other *** search
/ Macworld Expo - Developeā€¦Central & Net Innovations / Developer Central and Net Innovators (MacWorld Expo) (January 1999).iso / Developer Central / Metrowerks CodeWarrior / CodeWarrior Pro 4 Release Notes / PowerPlant Notes / Internet Classes Notes < prev    next >
Encoding:
Text File  |  1998-08-25  |  8.4 KB  |  186 lines  |  [TEXT/CWIE]
  1. ========================================================================
  2. Metrowerks PowerPlant Internet Classes Release Notes 
  3. ========================================================================
  4.  
  5. Version: PowerPlant 1.9.2
  6. Date:     10 August 1998
  7. Author:  Frank Vernon
  8. ========================================================================
  9.  
  10. IMPORTANT:    These classes require the use of the new PP Networking 
  11.             classes released with CW 11 or later.
  12.  
  13. ========================================================================
  14. New Features in This Version
  15. ========================================================================
  16.  
  17. *  Update to UInternet::GetGMTOffset() to better support timezones
  18.    offset from the hour. 
  19.    IMPORTANT: This interface has been changed! Previously this method
  20.               returned the GMT offset in hours. It now returns the
  21.               offset in seconds.
  22.  
  23.  
  24. ========================================================================
  25. Bugs Fixed in This Version
  26. ========================================================================
  27.  
  28. *  Fixed bug in POP3 and FTP classes when using the NOOP event to 
  29.    automatically keep connections alive.
  30.    
  31. *  Fix to LURL::GetSchemePart to properly prepend "//" to URL's in
  32.    all cases.
  33.    
  34. *  Fixed inline declaration issue with UInternetConfig object.
  35.  
  36. *  Fixed HTTP authentication problem that occured when the supplied
  37.    name and password combined were longer than approximately 30 
  38.    characters.
  39.    
  40. *  Fixed bug in FTP class where case-sensitive comparisons were
  41.    being made against result strings. This caused incompatability
  42.    with some servers.
  43.    
  44.  
  45. ========================================================================
  46. Known Bugs and Incompatibilities
  47. ========================================================================
  48.  
  49. *  The FTP classes can expose a known issue within the Thread Classes.
  50.    This can cause data loss and crashing. We are working on the issue
  51.    within the Thread classes to resolve this.
  52.       
  53.  
  54. ========================================================================
  55. Additional Notes
  56. ========================================================================
  57.  
  58. Overview: The PowerPlant Internet Classes are a set of classes for
  59. adding standards based Internet protocol support to your Macintosh
  60. Applications. Presently, these classes include support for: POP3/SMTP
  61. (Internet Mail), FTP (File Transfer), HTTP (Web Support), Finger
  62. (User location and identification), IRC (Internet Chat), and the 
  63. Internet Time protocol. In addition, a set of classes are included 
  64. for creating and parsing standard (RFC822) style Internet Messages 
  65. which include simple MIME support.
  66.  
  67. In most cases simple Internet functions like sending or retrieving mail,
  68. files, and Web information can be accomplished with a single call to the
  69. appropriate class. Complete control over the protocol connection is
  70. provided however. As much as possible, these classes have attempted to
  71. retain the concepts and terminology of the protocols they represent.
  72.  
  73. These Internet Classes are entirely thread based and require use of the
  74. PowerPlant Thread Classes. An example application is included (in both
  75. PPC and 68K versions) which demonstrates the basic functionality of each
  76. of the protocols supported. Several techniques for creating and managing
  77. thread based protocol support to your own applications are demonstrated.
  78.  
  79. While these classes greatly simplify the use of the Internet protocols,
  80. it is still highly recommended you familiarize yourself with the
  81. fundamentals of each before attempting to use them. RFC's for each of
  82. the protocols supported are included. Further information on Internet
  83. protocols and standards can be obtained from:
  84.     http://ds.internic.net/ds/dspg1intdoc.html
  85.  
  86. Class Descriptions:
  87. LInternetMessage -  Class for creating and parsing basic RFC822 
  88.                     style messages with simple Header and Message Body.
  89.     LMIMEMessage -  Subclass for dealing with MIME Messages.
  90.     LMailMessage -  Subclass (of LMIMEMessage) for dealing with
  91.                     Internet Style Mail Messages.
  92.     LHTTPMessage -  Subclass (of LMIMEMessage) for dealing with
  93.                     Internet Style HTTP Messages.
  94.  
  95. LHeaderField -      Class for creating and parsing RFC822 Style
  96.                     Message Header Fields. This class also handles 
  97.                     properly folding and unfolding header fields.
  98.  
  99. LInternetMessageList - 
  100.                     Class for handling a list of mail messages.
  101.  
  102. LHeaderFieldList -  Class for handling a list of header fields.
  103.  
  104. UInternet -         Utility class for dealing with misc. Internet
  105.                     related things.
  106.  
  107. UInternetConfig -   Utility class for handling the InternetConfig
  108.                     preferences system.
  109.  
  110. LDynamicBuffer -    Class for dealing with a resizeable Buffer.
  111.                     (Now uses Streams)
  112.                     
  113. LTemporaryFileStream - Class that uses a temporary file to 
  114.                     cache it's stream. The file is automatically
  115.                     created and destroyed along with the object.
  116.  
  117. LMacBinaryFile -    Class for reading and writting files
  118.                     using the MacBinary II file format. This 
  119.                     class is used primarily by the FTP classes 
  120.                     to transfer files in the MacBinary II format.
  121.  
  122. LURL -              Class for creating and parsing standard
  123.                     URL's. This class is intended to be a simple, 
  124.                     general URL class. It does however, know about 
  125.                     specifics of common URL's like FTP, HTTP, 
  126.                     MAILTO, and FILE. For these URL's, further 
  127.                     protocol specific information is accessible. 
  128.                     Other URL types are parsed into scheme and 
  129.                     schemepart only.
  130.  
  131. LInternetProtocol - Base class for handling typical Internet
  132.                     style protocols using TCP/IP.
  133.     LSMTPConnection -   Subclass for handling a SMTP connection.
  134.     LPOP3Connection -   Subclass for handling a POP3 connection.
  135.     LHTTPConnection -   Subclass for handling a HTTP connection.
  136.     LFTPConnection -    Subclass for handling a FTP Command connection.
  137.     LFTPDataConnection- Stand alone class for handling a FTP Data
  138.                         connection.
  139.                             NOTE: An FTP data connection will normally
  140.                             only be used by the LFTPConnection object.
  141.                             You should never have to call this class
  142.                             directly.
  143.     LFingerConnection - Subclass for handling a Finger connection.
  144.     LTimeConnection -   Subclass for handling a Time protocol 
  145.                         connection.
  146.  
  147. LInternetProtocolAsync - 
  148.                     Base class for handling typical Internet style
  149.                     protocols using TCP/IP which lend themselves to
  150.                     an asynchronous (event-driven) design.
  151.     LIRCConnection -    Subclass for handling an IRC connection.
  152.  
  153. LInternetResponse -     Base class for handling typical Internet style
  154.                     protocol responses which include a response
  155.                     number, and an associated textual response.
  156.     LSMTPResponse -     Subclass for handling a SMTP response.
  157.     LPOP3Response -     Subclass for handling a POP3 response.
  158.     LHTTPResponse -     Subclass for handling a HTTP response.
  159.     LFTPResponse -      Subclass for handling a FTP response.
  160.     LFingerResponse -   Subclass for handling a Finger response.
  161.     LIRCResponse -      Subclass for handling an IRC response.
  162.             
  163.             NOTE:   Many of the methods within the LInternetProtocol
  164.                     subclasses throw the corresponding subclass of
  165.                     LNetResponse in the event of a server generated
  166.                     error. You can use these in your own catch routines
  167.                     to determine the exact nature of an error condition.
  168.  
  169.  
  170. ========================================================================
  171. Contacting Metrowerks
  172. ========================================================================
  173.  
  174. For bug reports, technical questions, and suggestions, please use the
  175. forms in the Release Notes folder on the CD, and send them to
  176.  
  177. support@metrowerks.com
  178.  
  179. See the CodeWarrior on the Nets document in the Release Notes folder for
  180. more contact information, including a list of Internet newsgroups, 
  181. online services, and patch and update sites.
  182.  
  183. ========================================================================
  184.  
  185. Metrowerks Corporation
  186.